home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 April / Macworld (1999-04).dmg / Serious Software / SURFdriver 3.0 demo / Other Tools / TXT to SDV converter / Read Me! < prev    next >
Text File  |  1998-06-25  |  3KB  |  83 lines

  1. TXT -> SDV converter
  2.  
  3. The TXT->SDV program converts a series of coordinates in a special form into a SURFdriver file. It can be used to import files created on a Windows version of SURFdriver to the Mac version, or to convert data from other files into SURFdriver object files.
  4.  
  5. Double-click on the program to initiate a conversion. Give the full path of the file name (e.g. Hard Drive:Desktop Folder:Files:The File Name). If you aren't familiar with the Macintosh path conventions, put the file in the same folder as TXT->SDV and just type in the file name.
  6.  
  7. Choose and output file name, again giving a full path. If no path is given, the output file will be saved to the directory containing TXT->SDV. If there are errors during the conversion, they will be stored in the file named "logfile.txt". This file can be read using SimpleText or TeachText.
  8.  
  9. A sample of the format is shown below, and in the file named "Sample".
  10.  
  11. The values at the beginning (i.e. First Image Name, Slice Width, etc) can be left out, but you will be prompted to enter them at conversion time if they are not in the file.
  12.  
  13. The Slice #'s must  correspond to the z value (or depth) of the coordinates in that slice given the Slice Thickness value. So if your Z values are in multiples of 5 starting at 100, for example, you would set the Slice Thickness to 5, the Slice Interval to 1, and you could put the coordinates with Z values of 100 in Slice #1, the coordinates with Z values of 105 in Slice #2, etc. You can leave out any slices which do not contain any coordinates.
  14.  
  15. The Slice Width represents right-hand side of the screen; so if your maximum x value is 1000, you would set the Slice Width to a value just over 1000.
  16.  
  17. Each group of points must be organized into contours. If you have a split or join, start the splitting branch in a new contour number. A "Top Contour" indicates a top cap. A "Bottom Contour" indicates a bottom cap.
  18.  
  19. To create markers, use the "Markers" tag instead of the "Contour #" tag. Give the X,Y and Z coordinates, and the radius of the marker, on each line. If you don't know what radius to use, just give the X, Y and Z coordinates.
  20.  
  21. Your X and Y values should not be less than 0. If you have negative values, translate all points into positive values before doing your conversion.
  22.  
  23. A sample input file follows the dashed line.
  24.  
  25. -----------------------------------------------------------------------------------
  26.  
  27. First Image Name = Y.1
  28. Slice Width = 500
  29. Slice Thickness = 50
  30. Slice Interval = 1
  31. Color = Blue
  32.  
  33. Slice #1
  34. Top Contour #1
  35. 340.188,225.281,0
  36. 353.875,228.313,0
  37. 362.25,237.438,0
  38. 366.063,251.156,0
  39. 362.25,264.844,0
  40. 353.125,273.219,0
  41. 339.406,275.5,0
  42. 325.719,271.688,0
  43. 318.125,261.781,0
  44. 315.844,248.094,0
  45. 320.406,235.156,0
  46. 330.281,227.563,0
  47.  
  48. Slice #2
  49. Contour #1
  50. 337.125,225.281,50
  51. 350.844,228.313,50
  52. 359.219,237.438,50
  53. 363.781,250.375,50
  54. 359.219,263.313,50
  55. 350.844,272.438,50
  56. 337.125,276.25,50
  57. 324.188,271.688,50
  58. 315.844,262.563,50
  59. 312.031,248.844,50
  60. 317.344,236.688,50
  61. 325.719,227.563,50
  62.  
  63. Markers
  64. 329.531,244.281,50,5
  65. 352.344,246.563,50,5
  66. 337.906,262.563,50,5
  67.  
  68. Slice #3
  69. Bottom Contour #1
  70. 332.563,225.281,100
  71. 346.281,228.313,100
  72. 354.656,237.438,100
  73. 359.219,250.375,100
  74. 354.656,263.313,100
  75. 346.281,272.438,100
  76. 332.563,276.25,100
  77. 319.625,271.688,100
  78. 311.25,262.563,100
  79. 307.469,248.844,100
  80. 312.781,236.688,100
  81. 321.156,227.563,100
  82.  
  83.